You can use a custom domain for your payment links in vaultera switch. This means the payment link will use your own branded domain instead of a default vaultera switch domain.
To enable this, contact vaultera switch support. We will configure the domain on our end and provide a TLS certificate.

​
🔧 Setting Up a Custom Domain on Your Cloud

​
1. Identify Your DNS Provider

First, determine who manages your DNS records. This is typically your domain registrar, but it might be a different provider. If you’re unsure, you can find your DNS provider by running the following command in your terminal: 
nslookup -querytype=NS yourdomain.com
Replace yourdomain.com with your actual domain name. The output will list the name servers managing your DNS.

​
2. Create Required DNS Records

To link your custom domain to vaultera switch, follow these steps:
Step 1: Sign In to Your DNS Provider
Log in to your DNS provider’s control panel (e.g., GoDaddy, Cloudflare, AWS Route 53).
Step 2: Navigate to DNS Settings
Locate the section where you can manage DNS records for your domain.
Step 3: Create a CNAME Record
Create a new CNAME record to point your subdomain to vaultera switch.
FieldInstructionsDescription
TypeSelect CNAMESpecifies the record type
NameFor paymentlink.xyz.com, enter paymentlinkThe subdomain (prefix before the first dot)
Valuestaging.switch.vaultera.coPoints to the vaultera switch server (check if your provider requires a trailing dot)
TTL/Expiry300Sets the record to expire after 5 minutes
Step 4: Create a TXT Record
This TXT record is required for domain ownership verification and TLS certificate provisioning.
FieldInstructionsDescription
TypeSelect TXTSpecifies the record type
Name_acme-challenge.paymentlinkUsed for certificate validation
ValuePaste the value provided by vaultera switchA unique verification string
TTL/Expiry300A 5-minute expiration is sufficient
Step 5: Verify Your CNAME Record
Run the following command to verify the CNAME record: 
nslookup -querytype=CNAME paymentlink.xyz.com
Expected output: 
<your subdomain>  canonical name = staging.switch.vaultera.co
Step 6: Verify Your TXT Record
Check that the TXT record has propagated: 
nslookup -querytype=TXT _acme-challenge.paymentlink.xyz.com
Expected output: 
_acme-challenge.<your domain> text = "<your unique TXT record value>"
If the value doesn’t show up, wait a few more minutes and try again.

​
✅ What Happens Next?

Once your DNS records are correctly configured and verified, vaultera switch will validate your domain and provision it on our end. You will receive a confirmation email when the domain is ready to use.

​
💳 Enabling Wallets (Apple Pay & Google Pay) with Custom Domains

To enable Apple Pay or Google Pay in payment links, you need to validate your custom domain with Apple or Google. This is necessary to:
  • Generate Apple Pay or Google Pay session tokens.
  • Ensure the wallets work correctly in your payment link flow.

​
Steps:

  1. Set up your custom domain as described above.
  2. Obtain and register the respective Apple Pay or Google Pay certificates.
  3. Upload and configure these certificates within the vaultera switch dashboard.
Wallet support via payment links is only available when using custom domains due to domain-based validation requirements from Apple and Google.